home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / status / omnimoni.0 / omnimoni / OmniMoni / INSTALL < prev    next >
Encoding:
Text File  |  1995-11-12  |  3.0 KB  |  102 lines
  1. Testing OmniMoni
  2. ----------------
  3.  
  4. If you just want to see a sample of what OmniMoni can do the run the
  5. Demonstration script.  If wish is in your path then just run:
  6.  
  7.     wish -f Demonstration
  8.  
  9.  
  10. If you want to try OmniMoni out without installing you should set the
  11. environmental variable OMNIMONI_LIB to the pics directory.  In sh or
  12. bash you can do this as:
  13.  
  14.     OMNIMONI_LIB=`pwd`/pics
  15.     export OMNIMONI_LIB
  16.  
  17. After this you can just run OmniMoni as:
  18.  
  19.     wish -f `pwd`/bin/omnimoni.tcl -f config_file
  20.  
  21. For testing purposes you can use any of the sample configuration files
  22. in the demos directory or create your own.
  23.  
  24.  
  25.  
  26. Installing OmniMoni
  27. -------------------
  28.  
  29. You should just have to run the install script "install.tcl".  If
  30. tclsh is not in the place the script expects it or if you use a
  31. different Tcl interpreter then run the script as:
  32.  
  33.     tclsh install.tcl
  34.  
  35. This script will ask you some questions and then install OmniMoni,
  36. it's necessary files, and the man page.  If you are installing it
  37. system wide then you will probably need to be root to do this.
  38.  
  39. After running the installation script you will need to create a
  40. configuration file.  By default this file goes in ~/.omnimoni.  There
  41. are a number of samples in the demos directory.
  42.  
  43.  
  44.  
  45. If you do not wish to run my installation script or if it does not
  46. work for some reason, here's what it does:
  47.  
  48.  
  49. 1.  It finds out where "wish" is and prepends a line to the OmniMoni
  50. src file "src/omnimoni.tcl".  The line it prepends is:
  51.  
  52.     #!$wish_path/wish -f
  53.  
  54.  
  55. 2.  It finds out which, if any, of the GIF files you wish to use.  If
  56. you want to use any, then it asks where they should be installed. If
  57. they are not being installed in "/usr/local/lib/omnimoni", then it
  58. also create a launcher shell script that sets the environmental
  59. variable "OMNIMONI_LIB" to the specified lib path and then runs
  60. OmniMoni.
  61.     Also, depending on what GIF files are installed, it updates
  62. the manual page to reflect this in the "FILES" section.  It does this
  63. by appending the lines:
  64.  
  65.  
  66. .TP
  67. .BI omnimoni_lib_path/omnimoni.big.gif
  68. The large picutre show while OmniMoni parses the confuration file.
  69.  
  70.  
  71. and/or the lines:
  72.  
  73.  
  74. .TP
  75. .BI omnimoni_lib_path/omnimoni.small.gif
  76. The small picture show after OmniMoni is done parsing the
  77. configuration file.
  78.  
  79.  
  80. to the file "man/omnimoni.man.part1", it then append
  81. "man/omnimoni.man.part2" to it as well.
  82.  
  83.  
  84. 3.  It finds out the bin and man path for omnimoni and omnimoni.1
  85. respectively.
  86.  
  87.  
  88. 4.  Finally, the scipts does the following:
  89.  
  90.     A.  installs omnimoni.big.gif and/or omnimoni.small.gif are
  91. put in omnimoni_lib_path wish 444 permissions.
  92.  
  93.     B.  installs the created man page into the man path as
  94. "omnimoni.1" with 444 permissions.
  95.  
  96.     B.  if a launcher shell script was necessary it installs that
  97. in the bin path as "omnimoni" with 755 permissions and installs the real
  98. "src/omnimoni.tcl" file in the omnimoni_lib_path as "omnimoni.tcl"
  99. with 555 permissions.  If a launcher shell script was not necessary
  100. then it just installs the "src/omnimoni.tcl" script into the bin path
  101. with 755 permissions.
  102.